configure log target match

configure log target [console | memory-buffer | nvram | primary-node| backp-node | session | syslog [all | ipaddress {udp-port {udp_port}} | ipPort | ipaddress tls-port {tls_port} ] {vr vr_name} {local0 ... local7}] match [any |match-expression]

Description

Associates a match expression to a target.

In a stack, this command is applicable only on a Master and Backup nodes. This command is not applicable for standby nodes.

Syntax Description

console Specifies the console display.
memory-buffer Specifies the switch memory buffer.
nvram Specifies the switch NVRAM.
primary-node Specifies the primary node in a stack.
backup-node Specifies the backup-node in a stack.
session Specifies the current session (including console display).
syslog Specifies a syslog target.
all Specifies all of the remote syslog servers.
ipaddress Specifies the syslog IP address.
ipPort Specifies the UDP port number for the syslog target.
vr_name

Specifies the virtual router that can reach the server IP address.

Note: User-created VRs are supported only on the platforms listed for this feature in the Switch Engine v33.1.1 Licensing Guide document.
local0 ... local7 Specifies the local syslog facility.
any Specifies that any messages will match. This effectively removes a previously configured match expression.
match-expression Specifies a regular expression. Only messages that match the regular expression will be sent.

Default

By default, targets do not have a match expression. If a virtual router is not specified, VR-Mgmt is used.

Usage Guidelines

This command configures the specified target with a match expression. The filter associated with the target is not affected. A message is sent to a target if the target has been enabled, the message passes the associated filter, the message is at least as severe as the configured severity level, and the message output matches the regular expression specified.

See the command show log for a detailed description of simple regular expressions. By default, targets do not have a match expression.

Specifying any instead of match-expression effectively removes a match expression that had been previously configured, causing any message to be sent that has satisfied all of the other requirements.

To see the configuration of a target, use the following command:

show log configuration target {console | memory-buffer | nvram | primary-node | backup-node | session | syslog {ipaddress {udp-port {udp_port }}| ipPort |ipaddress tls-port {tls_port}} {vr vr_name} {[local0...local7]}}

To see the current configuration of a filter, use the following command:

show log configuration filter {filter name}

Example

The following command sends log messages to the current session, that pass the current filter and severity level, and contain the string user5:

configure log target session match user5

History

This command was first available in ExtremeXOS 10.1.

The ipPort parameter was first available in ExtremeXOS 11.1.

The udp-port parameter was added in ExtremeXOS 21.1.

Platform Availability

This command is available on all Universal switches supported in this document.